home *** CD-ROM | disk | FTP | other *** search
/ Power CD-ROM!! 8 / Power CD-ROM 8.iso / os2 / vxftp42 / readme < prev    next >
Encoding:
Text File  |  1994-10-12  |  8.5 KB  |  190 lines
  1. last updated October 12, 1994
  2.  
  3.                       /* **************************** *
  4.                        *                              *
  5.                        *          V x F T P           *
  6.                        *             beta             *
  7.                        *                              *
  8.                        *      by Howard T. Hyten      *
  9.                        *    hhyten@mail.utexas.edu    *
  10.                        *                              *
  11.                        * Multi-threaded FTP for OS/2  *
  12.                        *                              *
  13.                        * **************************** */
  14.  
  15. ==> Since VxFTP includes no HELP system at this time, YOU SHOULD 
  16. READ THIS README FILE FOR AN EXPLANATION OF HOW TO USE IT.
  17. ==> If nothing else, try using the right mouse button a lot. :)
  18.  
  19. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=--=-=-=-=-=-=-=-=-=-=-=-=-
  20. INSTALLATION:
  21.  
  22. Execute INSTALL.EXE to install VxFTP properly. The install process
  23. will add  VROBJ.DLL to your OS2\DLL directory and RXFTP.DLL to your
  24. TCPIP\DLL directory. It will also create a VxFTP program object on
  25. your Desktop.
  26.  
  27. Requirements: You must have IBM TCP/IP for OS/2, either 1.2.1 or 2.x,
  28. installed on your machine.
  29.  
  30. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=--=-=-=-=-=-=-=-=-=-=-=-=-
  31. UPDATES:
  32.  
  33. If you'd like notification of updates to VxFTP, send mail to
  34. hhyten@mail.utexas.edu to add you to the Update mailing list.
  35.  
  36. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=--=-=-=-=-=-=-=-=-=-=-=-=-
  37.  
  38. Multiple Threads:
  39. -----------------
  40. VxFTP is multi-threaded, thanks to the multi-threading capabilities of 
  41. Watcom's VX-REXX on top of which VxFTP is built. Multi-threading makes
  42. the application more responsive to the user. Since it is founded on REXX,
  43. VxFTP would be unbearably slow if all tasks were obliged to follow one 
  44. another sequentially. Basically, VxFTP uses two threads, one for local 
  45. disk access and updating the user interface, and another that talks to the 
  46. remote host. Thus, if you've changed to another directory remotely and 
  47. are waiting for the directory contents to be downloaded, you can still
  48. affect changes on the local file side.
  49.  
  50.  
  51. USING VxFTP:
  52. ===============
  53. Start VxFTP as you would any other OS/2 PM application, either from the 
  54. command line or by double-clicking its object somewhere on the desktop.
  55. (The installation program creates a WorkPlace Shell object for you.)
  56.  
  57. Once VxFTP loads, a dialog box appears for you to enter the remote host's
  58. name (or IP address), the logon account and password you want to use, and,
  59. optionally, the directory on the remote host you want to change to upon
  60. logging in. 
  61.  
  62. You can also provide command-line parameters in the form of:
  63.  
  64.     vxftp host userid [password] [directory]
  65.  
  66. For example, to log into kelly with my account and change to my docs directory:
  67.  
  68.     vxftp kelly.utexas.edu hhyten secrets docs
  69.  
  70.  
  71. Anonymous FTPs:
  72. --------------
  73. Clicking on the "Anonymous FTP" check-box in the login dialog box will fill
  74. in "anonymous" and an Internet email address in the login and password fields,
  75. respectively. You can modify the email address in the Settings notebook. For
  76. example, to log into ftp.cdrom.com anonymously, you would type:
  77.  
  78.     vxftp ftp.cdrom.com anonymous
  79. or
  80.     vxftp ftp.cdrom.com anon
  81.  
  82. ("Anonymous" can be abbreviated to "anon".)
  83.  
  84. Transferring Files:
  85. ---------------
  86. To PUT or GET files, you can select one or multiple files, and click the
  87. "Put" or "Get" button. VxFTP will then transfer the file(s) you've
  88. selected. You can also transmit files by selecting them and right-mouse-
  89. clicking for a pop-up menu. (Since these interface elements are lists,
  90. and *not* containers, you must first select a file or directory (or 
  91. Shift-Click or Ctrl-Click) before obtaining a pop-up menu.
  92.  
  93. Right-mouse Button:
  94. -------------------
  95. To operate on remote or local files or directories (that is, to rename, 
  96. get, put, delete, or view), use the right-mouse button after selecting the 
  97. files or directories you want (again, these are lists, not containers, so
  98. you must select the files or directories first). Choose the operation 
  99. you desire from the pop-up menu.
  100.  
  101. Managing File Archives:
  102. -----------------------
  103. On the local side, the selection "Unzip" allows you to unzip a ZIP archive,
  104. provided you have InfoZIP's unzip.exe or PKZIp's PKUnzip.exe in your path. 
  105. You can also start an executable or command/batch file from VxFTP by 
  106. choosing "Execute". Use "View" to view a text file in a viewer. (On the 
  107. remote side, you can also download a text file to view in the viewer.)
  108.  
  109. If you specify a /K parameter in the COMSPEC statement in your CONFIG.SYS,
  110. the Unzip and Execute functions will work only if you start VxFTP from the 
  111. command line. If you want these functions to work after launching from the
  112. Desktop, remove the parameter in your CONFIG.SYS and place it in the "OS/2
  113. Window" and "OS/2 Full Screen" objects' parameter line.
  114.  
  115.  
  116. Recognizing Hosts:
  117. -----------------
  118. With release 0.40, VxFTP can display listings from most UNIX hosts (though
  119. ftp.nmsu.edu is problematic), other PCs running IBM's TCP/IP for OS/2, 
  120. Macintoshes running FTPd, DEC VMS, and IBM VM. VxFTP supports any 
  121. platform that provides a 'standard' UNIX file listing. I believe this
  122. covers 95% of the platforms in general use.
  123.  
  124. If you log onto a host and don't receive a file and directory listing,
  125. check first that VxFTP correctly detected the OS of the remote system. 
  126. Go to "Remote" - "System Type". Choose the operating system of the 
  127. remote host and click "Remote" - "Refresh Lists". If choosing an OS from 
  128. the menu still doesn't make files appear in the lists, use the "Remote" - 
  129. "Long Dir Listing" to view what VxFTP downloaded from the host and 
  130. was not able to interpret. You can use the information in the long-style 
  131. listing to navigate around the remote file system.
  132.  
  133. Directory Contents Cache
  134. -----------------------
  135.  
  136. Version 0.42 adds a directory cache where VxFTP stores the contents
  137. of the remote site's directory listings (the default behaviour). You can
  138. disable caching by using the Notebook Settings page, "Cache". You can
  139. also control how many directories to cache (up to 15, default 10) and 
  140. how long to cache them before refreshing (up to an hour, default 30
  141. minutes). You can also browse the cached directories by using the 
  142. "View Cached Dirs" menu under "Remote". A non-modal box appears
  143. from which you can choose directories.
  144.  
  145. These features should substantially enhance performance on SLIP and 
  146. PPP connections, as well as other slow links.
  147.  
  148. In the works:
  149. -------------
  150. VxFTP v0.4x is still a beta. There are still several user options I want
  151. to add to the Settings Notebook.
  152.  
  153.      Yes, I know it'd be great if VxFTP provided some indication 
  154.      as to a file transfer's progress. Like most things IBM, the 
  155.      OS/2 FTP API is "non-standard" enough that it does *NOT* 
  156.      support getting information on the amount of data being 
  157.      transmitted. It also does *NOT* provide the text or numeric 
  158.      codes typical to FTP command conversations. Sorry. 
  159.  
  160.  
  161. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  162. LEGALESE:
  163. VxFTP is built on top of IBM's RXFTP REXX extensions (by Patrick Mueller) 
  164. and using Watcom's excellent, multithreading VX-REXX. 
  165.  
  166. VxFTP.EXE is FREEWARE, not SHAREWARE. This means that the executable is 
  167. under my copyright, but users may freely distribute and share it without 
  168. having to think of giving me a dime. (A postcard would be great though!)
  169. When you distribute this program, you must include this readme.
  170.  
  171. Commercial distribution and/or use is prohibited without written consent from
  172. the author, except in cases where a collection of shareware, freeware, or 
  173. public domain programs is compiled on CD-ROM, such as the Walnut Creek 
  174. CD-ROM. This exception does not cover diskettes, as in ones included with 
  175. books. Because the program is licensed free of charge, there is no
  176. warranty for the program, to the extent permitted by applicable law. Except
  177. when otherwise stated in writing the copyright holder provides 
  178. the program "AS IS" without warranty of any kind, either expressed or
  179. implied, including, but not limited to, the implied warranties of
  180. merchantability and fitness for a particular purpose. The entire risk as to
  181. the quality and performance of the program is with you, the user. Should the
  182. program prove defective, you assume the cost of all necessary servicing, 
  183. repair, or correction.
  184.  
  185.  
  186. CONTACT INFO:
  187. hhyten@mail.utexas.edu
  188. Howard T. Hyten
  189. 1200 Barton Hill Drive #222
  190. Austin, TX 78704-1910